home *** CD-ROM | disk | FTP | other *** search
/ Total Network Tools 2002 / NextStepPublishing-TotalNetworkTools2002-Win95.iso / Archive / FTP Server / SunFTP Server Project.EXE / instructions.txt next >
Encoding:
Text File  |  1999-08-25  |  8.4 KB  |  225 lines
  1. SunFTP Server Project, instruction booklet v0.0.1
  2.  
  3. written by NGin, xs4all network
  4. for Build: 9(1) and bejoynd
  5.  
  6. Language: UK English or whatever it's called
  7.  
  8.  
  9. Warning:
  10. the instructions in this file are basic, some functions
  11. may have been let out or the information is not "up'to date".
  12.  
  13.  
  14.  
  15.  
  16.  
  17. --==[ Introduction ]==--
  18.  
  19. Welcome to SunFTP Server Project,
  20.  
  21. Now you may wonder, why the hell another FTP Server?
  22. Well, first of all, it's not just another FTP Server, infact
  23. it's the first of its kind. A brand new project based on Object Pascal
  24. or in other words "Delphi Code".
  25.  
  26. SSP was first intended as a "School Project". But since I (NGin)
  27. personally never written a fully working FTP Server before, I decided
  28. to share my work with other people and from this stage SSP have been
  29. released as Open Source, anyone can join the project or infact
  30. use the code on their own.
  31.  
  32. SSP is not using Assembler/C/C++ or other developement tools, no it's
  33. a pure art of work in Object Pascal for Win32, which makes it even
  34. easier to join. Code should be compatible with all versions of
  35. Delphi, but unfortunateley there have been reports on Delphi 3 Std,
  36. Delphi 4 Desktop and Delphi 5 doesn't compile the code correct, but
  37. so let it be.
  38.  
  39. SSP Offers:
  40.  
  41.  - Easy user management (thanks to Jan Tomasek)
  42.  - Dirfferent permissions for each user (R/W/D/L)
  43.  - Hide real real PATH from users (thanks to Jan Tomasek)
  44.  - Powerful authorization procedure (thanks to Jan Tomasek)
  45.  - IP based security (thanks to Rasmus Allenheim)
  46.  - Welcome/Goodbye messages (thanks to Jan Tomasek)
  47.  - Enough options for most people
  48.  - Open Source (available under "lesser" GPL)
  49.  - Slick User Interface (SUI)
  50.  - and much more...
  51.  
  52. If this isn't enough for you, go and look elsewere!
  53.  
  54. --==[ How can I compile source ]==--
  55.  
  56. First of all, get yourself a copy of Delphi 3 (Pro or C/S).
  57. Download the components RX Libs from http://rx.demo.ru and install
  58. them, secondly download the components ICS from http://rtfm.be/fpiette
  59. and install them to. Those components are freeware, so get them.
  60.  
  61. Now you should have a look in the SunFTP Src dir "\Units" there is
  62. a Delphi package ready to install in Delphi 3 (SunFTP.dpl).
  63. Now open the project and press <CTRL>+<F9>, watch the screen for
  64. errors, no one should occur, maybe just some warnings, thats it!
  65.  
  66. Now run the file "SunFTP.exe" and have fun, if you don't want to
  67. do this, browse to the URL: http://xs4all.dk/sunftp/download.shtml
  68. and download the compiled binary. Doohh.
  69.  
  70. --==[ About this booklet and other install tips ]==--
  71.  
  72. First of all, I'm NGin, it was me who started the SunFTP Server Project
  73. in back in July 1999. I have written this document espescially for
  74. you, sorry for my bad english, please don't correct me.
  75. I don't like personally to write help files nor files like this one,
  76. so maybe this document doesn't fit your needs, and I couldn't care less.
  77.  
  78. There may be some other SSP documents out there in CyberSpace written
  79. by someone else other than me, but I don't know of any, this documents
  80. why.
  81.  
  82. --==[ First time run ]==--
  83.  
  84. If you just installed SSP, then click and run the file "SunFTP.exe".
  85. You should now see a Message Dialog saying "Since the.. bla..bla.."
  86. or something like it, now you should see the properties dialog
  87. or configuration screen. Set the options as you want them:
  88.  
  89. Server ->
  90.  Port:        This is default set to be 21. 21 is used by almost any
  91.               ftp clients today, so leave this in default mode.
  92.  Max Clients: This indicates the maximum of allowed clients to
  93.               be connected to SSP. Default value is set to 10, this
  94.               is enough in most cases. If you enter 0, then the
  95.               number of max clients are infinite. You can have the
  96.               maximum of 999 clients connected to SSP.
  97.  Server msg:  This is the FTP Banner message, goes like:
  98.               220 My FTP Server ready on port 21...
  99.  Restrict IP: This is the message to be shown when a not allowed
  100.               client tries to connect to the FTP Server.
  101.  
  102. System ->
  103.  
  104.  Autostart:   This will autostart the FTP Server when it is started.
  105.  Minimize:    Minimize SSP to the system tray when it is minimized
  106.               or launched.
  107.  AutSt.Every: This enables the SSP to be a part of your system, it
  108.               will be launched automatically every Windows session.
  109.  
  110. Logging ->
  111.  
  112.  Max lines:   This is the maximum lines to be displayed in the Logfile
  113.               message box, default value is set to 1000 lines, you
  114.               can increase and decrease the value, no max values
  115.               are there.
  116.  Enable:      This enables SSP to save the Logfile message box contents
  117.               to a chosen file. Default name is: ftp.log, change it
  118.               to your own personallt favourite ;)
  119.  
  120. IP Restriction ->
  121.  
  122.  Rest.IP's:   This is a list of IP addresses, all the added are being
  123.               let out and the Restrict IP Msg. is showed. Click
  124.               Add, Delete or Clear, button captions explains their
  125.               respective functions.
  126.  
  127. Messages ->
  128.  
  129.  Welcome msg: This message is being showed when a client connects
  130.               to the FTP Server, it goes like:
  131.  
  132.               220-Welcome to xs4all ftp services, all actions on this
  133.               220-ftp server are being logged, now you're warned!
  134.               220
  135.  Goodbye msg: This message is being showed when a client disconnects
  136.               from the FTP Server, just like the welcome message.
  137.  
  138. Now click "OK" and the FTP Server is ready to be operated, but first we
  139. have to add some users.
  140.  
  141. Click the "User Manager" button and a new screen should appear.
  142.  
  143. Now click the "Add" button and the user name "Anonymous" should apear
  144. among with the options:
  145.  
  146.  Password: ********* (randomized)
  147.  Home directory: SSPDir\users\user_anonymous\
  148.  Permissions: None
  149.  
  150. Now you can change the password to your own, e.g.: anon
  151. Remember to change the permissions, avail permissions are: R,W,D,L
  152. I would suggest: R,W for anonymous logins
  153.  
  154. To create a new user, simply click the button "Add" again
  155. To change the home directory, click the button with the folder on it.
  156. Now you can choose directory for the user, to create a new one simply
  157. select dir and right click your mouse button. Thats it.
  158.  
  159. When you're finished, click on the button "Close" and start the
  160. FTP Server.
  161.  
  162. --==[ Administer SSP ]==--
  163.  
  164. To be the administrator of a SSP server isn't hard at all. SSP is cosidered
  165. to be one of the most simple FTP Servers available on the market today
  166. which is still free to use.
  167.  
  168. When you have started the SSP, you will get the information:
  169.  
  170. (In the Logfile message box)
  171. 1999.08.25 19:02:38 -- FTP Server started (21, 10.10.10.2)
  172. 1999.08.25 19:02:38 -- Logging actions to file D:\SunFTP\logs\ftp.log
  173.  
  174. It may not be like as shown above, but something like it.
  175.  
  176. Explanation of the logged options:
  177.  
  178. 1999.08.25 19:02:38, is the time of an event
  179. -- FTP Server started (21, 10.10.10.2), is the action taken
  180.  
  181. In this case we have the information "(21, 10.10.10.2)", which means:
  182. 21 is the Port number the FTP Server is running on and the 10.10.10.2
  183. is the IP Address. You can easily get the IP by clicking <ALT>+<I>
  184. The IP address is shown in the logbox as well as it is copied to the
  185. clipboard (paste into any other Win app via <CTRL>+<V>).
  186.  
  187. To clear the logbox, simply click <ALT>+<R>.
  188. To shutdown the FTP Server immediately, simply click <ALT>+<CTRL>+<T>
  189.  
  190. Well I guess that's all. To view the saved logfile goto: SSPDir\logs\
  191. and list the file named "ftp.log".
  192.  
  193. --==[ FAQ - Frequently Asked Questions ]==--
  194.  
  195. Q. Can I please have the source, pretty pretty please?
  196. A. It's Open Source, what do you think punk?
  197.  
  198. Q. Can I run SSP as a System Service with NT?
  199. A. Yepp, with help from the tool SrvAny, let me know if it
  200.    works for you!
  201.  
  202. Q. Will there ever be a .HLP file available for SSP?
  203. A. I don't think so, isn't this file enough?
  204.  
  205. Q. How compatible are SSP with other FTP Servers?
  206. A. Just as compatible as any other :)
  207.  
  208. Q. Does SSP support RESUME?
  209. A. Yepp
  210.  
  211. Q. Can I distribute SSP on my own homepage, cd etc.?
  212. A. Read the file "license.txt" for further info, yes you may!
  213.  
  214. Q. Is it true that you doesn't offer any support?
  215. A. Me? Yes that's true, it's Open Source, no support from me!
  216.  
  217. Q. How can I contact the SSP Group?
  218. A. via the e-mail address: sunftp@xs4all.dk
  219.  
  220. Q. Hmm...
  221. A. Yes?
  222.  
  223. --==[ Some words from the author ]==--
  224.  
  225. Ok let me say this straight out: SSP makes me happy!